.. _cmmErrParseReason:

cmmErrParseReason
============================
----------------------------

SYNOPSIS
```````````

.. code-block:: none

   VT_I2 cmmErrParseReason(
    [in] VT_I4 ErrorCode
    )


DESCRIPTION
```````````````

- 에러코드로부터 에러(Error) 원인(Reason)을 얻습니다. 

PARAMETER
`````````````

-  ErrorCode : 마지막으로 발생한 에러코드 값.

RETURN VALUE
`````````````

- 발생한 에러에 대한 원인 코드.

REFERENCE
```````````

.. note:: 
    이 함수는 cmmErrParseReason 와 함께 단 두개 함수만이 리턴 타입이 VT_I2 이며, 이 리턴값이 다른 함수들 처럼 
    VT_I4 형태의 에러코드가 아님을 주의해주시기 바랍니다.

EXAMPLE
`````````````

.. code-block:: c++
 :linenos:
 :emphasize-lines: 5

 C/C++

 void SomeFunction(...)
 {
  char szTemp[254+1];
 
  // 각 변수는 2 바이트형임을 주의합니다.
  short int ErrorParseAxis = 0;
  short int ErrorParseReason = 0;
  
  LONG dwErrCode;
 
  // Error 코드를 확인합니다.
  cmmErrGetLastCode(&dwErrCode);
 
  // Error 코드를 통해 에러를 발생시킨 축의 번호를 얻어옵니다.
  ErrorParseAxis = cmmErrParseAxis(dwErrCode);
 
  // Error 코드를 통해 에러를 발생시킨 에러번호(Error Code)를 얻어옵니다.
  ErrorParseReason = cmmErrParseReason(dwErrCode);

  sprintf(szTemp,"[LastErrorCode %d], [ErrorParseAxis : %d], 
            [ErrorParseReason %d]",dwErrCode,ErrorParseAxis,ErrorParseReason);

}


.. code-block:: none
 :linenos:

 Visual Basic

 Private Sub SomeFunction(…)

    Dim szTemp(254+1) As Byte
    Dim ErrorParseAxis As Integer
    Dim ErrorParseReason As Integer
    Dim dwErrCode As Long

    ErrorParseAxis = 0
    ErrorParseReason = 0

    ‘ Error 코드를 확인합니다.
    Call cmmErrGetLastCode(dwErrCode)

    ‘ Error 코드를 통해 에러를 발생시킨 축의 번호를 얻어옵니다.
    ErrorParseAxis = cmmErrParseAxis(dwErrCode)

    ‘ Error 코드를 통해 에러를 발생시킨 에러번호(Error Code)를 얻어옵니다.
    ErrorParseReason = cmmErrParseReason(dwErrCode)

 End Sub


.. code-block:: none
 :linenos:

 Delphi

 Procedure SomeFunction(…);
 var

    szTemp : array[0..255] of Char;
    ErrorParseAxis : SmallInt;
    ErrorParseReason : SmallInt;
    dwErrCode : LongInt;

 begin

    // 각 변수는 2 바이트형임을 주의합니다.
    ErrorParseAxis := 0;
    ErrorParseReason := 0;
 
    // Error 코드를 확인합니다.
    cmmErrGetLastCode(@dwErrCode);
    
    // Error 코드를 통해 에러를 발생시킨 축의 번호를 얻어옵니다.
    ErrorParseAxis := cmmErrParseAxis(dwErrCode);
 
    // Error 코드를 통해 에러를 발생시킨 에러번호(Error Code)를 얻어옵니다.
    ErrorParseReason := cmmErrParseReason(dwErrCode);

    ShowMessage(Format('[LastErrorCode %d],[ErrorParseAxis : %d],
                    [ErrorParseReason %d]',[ dwErrCode,ErrorParseAxis,ErrorParseReason]));
   
 end;